home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Amiga Collections: Amiga Amateur Radio User Group
/
AARUG UK #01 (1989-10)(Amiga Amateur Radio User Group UK)(PD)[m].zip
/
AARUG UK #01 (1989-10)(Amiga Amateur Radio User Group UK)(PD)[m].adf
/
UtiliMaster.DOC
/
UtiliMaster.DOC
Wrap
Text File
|
1993-12-02
|
16KB
|
355 lines
UtiliMaster
Programable buttons!
ARC Won't hang up on duplicate files!
Two windows (Source & Destination)!
Modify "Standard" buttons!
Icon doubles as configuration file!
Run from Workbench or CLI!
The top display window is ALLWAYS the source, the bottom
destination. The box above each display shows the current
directory being displayed. The three boxes in the lower
right are the Entry ("E") box, the source directory Disk
or Device name, and the destination directory Disk or
Device name. Swapping a disk while it's directory is
being displayed will automatically get the parent
directory of the new disk in the appropriate window.
To move into a sub-directory, "Double-Click" it's name.
(The time between two clicks to be considered double-clicking
is determined by Preferences.) To move to the parent of
the current directory, Double-Click the directory name
box (Above the list window). Double-Clicking the root
directory will cause Utilimaster to get it from the device
again. (This is useful if something outside Utilimaster
has changed you directory listing.)
If a symbol like a capital Y with a line thru it appears
just to the left of the filesize, that file is protected
to some state other than "rwed". If a C in a circle
appears, the file has a comment attached to it.
Standard buttons:
"Swap" Will swap the source and destination directories. Files
may not be selected in the destination window other than
Double-Clicking sub-directories. If source and
destination are swapped, selected files are not
highlighted in the destination window, but will
be remembered and highlighted in the source window
if directories are swapped back.
"All" Selects all files in source directory.
"AllDirs" Selects all sub-directories in source directory.
"Exchange" De-selects all selected and selects all unselected.
"ExcDirs" Same for directories.
"Clear" De-selects all selected files.
"ClrDirs" Same for directories.
"Copy" Copies all selected files and sub-directories (including
files in sub-directories) to destination directory.
Copy also copies file comments, and if NOLOCK=1 has
not been entered as a tooltype in the icon, protection
on the copy is set to the same as the orriginal. (If
protection on the orriginal is "r-e-" then the copy is
set to "r-e-".)
If you enter a FileName in the "E" box, and copy
a file, it will be renamed in the destination directory.
In this case, copy stops after the first FileName if
more than one is selected.
"Rename" Will rename the FIRST selected file or directory to
the name in the "E"(Entry) box. If no name appears
in the "E" box, a requester appears requesting the
new file name.
"Move" If destination directory is on the same device as source,
selected files will be moved into destination directory.
If not on the same device, an error message is displayed.
"Delete" Will present a requester asking if you are sure. Given
an affirmative, it will delete selected files. Selected
directories will be automatically deleted if empty.
For directories containing files, a requester appears
to remind you if they are not empty. Given an OK,
these directories, and all files and sub-directories
will be deleted. Empty directories are deleted with-
out any requester. (The theory is that an empty
directory is easy to re-create.)
"Lock" Changes the protection on selected files/directories to
"r-e-". They are protected from being written to or
deleted. Lock will protect all files in selected
directories. Lock fails if there is a system file-
lock on a file or directory. If a particular directory
repeatedly fails to lock, it may have something "assigned"
to it, or may be part of the "path" list.
"UnLock" Changes protection to "rwed".
"Read" Displays the selected file(s) to the screen. ASCII files
are displayed in text mode, binary etc. are displayed
as if "c:type opt h" were used, except that the decimal
file position is listed on the right side of the screen.
The Up & Down arrows, or scrollbar may be used to move
forward or backward thru the file. The window-close
gadget exits read. For keyboard instructions, select
a file, click "Read", and once the file is displayed,
push the "HELP" key. The choice of modes is based on
whether any 0 bytes are found. (ASCII text files
SHOULD NOT contain any 0 bytes!)
"FileNote" Attaches whatever is in the "E" box (Even a null
string!) as a comment to each selected file REPLACING
any existing comment. Using FileNote with the "E" box
empty will delete any existing comment.
"GetNote" Displays the comment on selected file(s) in the
Status box and the Filename in the "E" box. There is
a brief delay built in so you have a chance to read
them if more than one file is selected. Note that
commented files display a c in a circle just to the
left of their size in the display window.
"Print" By default, if Utilimaster can find a file named
"c:print" it will be RUN and passed the filename, if
not, an internal routine will print the file to PRT:.
The default external print routine can be changed.
See "Setting Defaults", below.
"Show" By default uses "c:show" to display the selected file(s).
Show can also be re-defined.
"Search" By default opens a window and calls "c:search" passing
it the content of the "E" box as the string to seek,
and selected file(s) to search.
"Arc" "DeArc" & "ListArc" by default all use "c:arc".
"Arc" opens a window and Executes
"c:Arc a Filename <FileName> <FileName>" for selected
file(s).
"DeArc" Opens an interactive window and Executes
"c:Arc x FileName". If duplicate files are found,
this version of UtiliMaster DOES NOT lock up in
the endless loop most others do!
"ListArc" Opens a window and Executes
"c:arc v FileName" The window remains open for
reading until you close it.
"Run" Is equivelant to typing "run > nil: FileName" from CLI.
No window is opened for your file by UtiliMaster.
"Edit" Defaults to "run e FileName"
"Execute" Defaults to "Execute FileName"
"GetDir" Gets the directory in the "E" box, which MUST begin
with a device name. If the "E" box is empty, the current
source directory is up-dated. Usefull if you have added
or deleted a file from some other program.
To get a sub-directory in a window, Double-Click on that
directory's name. To get the parent of any displayed
sub-directory, Double-Click on the Directory
name box at the top of the listing window.
"MakeDir" Will make a directory with the name in the "E" window.
If nothing appears in the "E" window, a requester appears.
If MakeDir was clicked with the LEFT button, the
directory will be created in the source directory.
If the RIGHT button was used, the new directory goes
in the destination.
"Info" Displays the number of USABLE bytes free on each device
in the window where the device name usually appears.
(Or free memory in the case of the Ram Disk) If any
files (NOT directories!) are selected, their total bytes
and number of x-modem blocks is disp[layed in the status
window.
"NewCLI" Will start up a new CLI if Utilimaster can find
"c:NewCLI". If a filename is selected the result is
"NewCLI from filename".
All of the "Device" (DF0: DF1: RAM: etc.) buttons may be
clicked with the LEFT mouse button to get the device
as the SOURCE directory, or with the RIGHT mouse button
to get it as the DESTINATION directory. All of these may
be re-programed to get other devices in the following
manner:
To change "VD0:" to "VDK:", select (SINGLE-Click) the
Utilimaster icon on the workbench screen. Select "Info"
from the workbench menu. Click the "ADD" box next to
the "ToolTypes" window. Click in the "ToolTypes" box
and type "VD0:=VDK:" Please note that "VD0:" MUST be
upper case, but "vdk:" may be lower case if you so
desire. If you want other text in the button for the
device, leave a space and enter up to 8 characters.
EXAMPLE: To change "SYS:" to call your "s:" directory
with the button lbeled "Scripts" add a tooltype line
which says "SYS:=s: Scripts"
EXAMPLE: To change "DH1:" to call up the directory
"SYS:MyFiles" and the button to display "All Mine"
add a tooltypes line of "DH1:=sys:myfiles "All Mine"".
Note that "All Mine" should be entered in the tooltypes
box in quotes!
Each time UtiliMaster is started (whether from workbench or CLI!)
the icon is parsed for these settings as well as those
described below.
UtiliMaster defaults to "SYS:" as the source, and "RAM:" as the
destination directories on startup. You can change this
by adding a tooltype line that says
"DEFAULT=Directory Directory". The first directory
listed will become the default source, the second
will become the destination. If only one directory
name is entered, only SYS: will be changed.
UtiliMaster allows you to dictate a command directory other than
"c:" To do so add a tooltype line
"COMMAND=DirectoryName". If the directory does not
exist, Utilimaster will attempt to create it. Utili-
Master will then attempt to copy "c:run","c:newcli",
"c:endcli","c:execute",and "c:assign" into this
directory. It will then attempt to "assign c:
DirectoryName". (This is due to the fact that the
DOS Execute() command invokes "c:run" in order to
function. The manx "exec()" commands don't need
"c:run", but won't function within a program started
from WorkBench!. They've got us between a rock and a
hard place!)
On exiting UtiliMaster, "c:" will be assigned to
"SYS:c" unless you specify elswhere by a tooltype
"REASSIGN=DirectoryName".
If Utilimaster created a new command directory,
it will be deleted. If you assigned command to
an existing directory, it will be left intact on
exiting UtiliMaster. (Including any files
UtiliMaster copied into it!)
Other utilities may be copied into your newly
created command directory via a tooltype
"COPYLIST=FileName FileName FileName (etc.)". All
FileNames should include the Device:.
There are four more buttons which do not appear unless defined
by the user as described below.
USER BUTTONS: (Including changes to Show, Print, Arc,
Search, etc.)
Each of the four user buttons is defined by a tooltype line.
"USER#=FileName ButtonText [flags] [Perameters] [PromptText]"
Where FileName is the FULL directory name of the program to
invoke.
ButtonText is the text (up to 8 characters) for the button.
Flags are desribed below.
Perameters (up to 8 characters) to pass to function).
PromptText (up to 30 characters) Is the Text to present in a
Requester if your program requires user input.
(Example: A fileName to create). If no promptext
is provided, no requester will appear.
Flags:
If your program is simply to be run (Example "sys:Clock"),
then flags=0. (You need not enter Perameters or Promptext
unless you want them. If you DO use perameters, then flags
should be entered as 0. If promptext is entered you MUST
enter flags (even if 0) and perameters (even if "")).
To RUN your program with selected FileName(s) passed to your
program, add 1. The result is as if typing:
"run >nil: CommandName FileName"
from CLI for EACH Selected File. If 1 is NOT added the result is
like typing:
"CommandName FileName" from CLI for each selected FileName.
To open a window for your program to output text (It thinks
it's running from CLI!) add 2.
To open a window from which your program can accept keyboard
input, add 4. DO NOT add 2 AND 4!
To have perameters passed BEFORE the FileName, enter
Perameters and add 8 to flags.
To have perameters passed AFTER the FileName, enter perameters
and add 16 to flags.
If you use an output only window (you added 2) and want the
window to close after each FileName has been passed, add 32.
Otherwise the window will remain open until you close it.
To exclude selected directories from being passed to your
program, add 64.
To run your program passing it only the current source
directory name, add 128. If you click the button with NO
filename selected, your program will be started as dictated
by the other flags but passed the string appearing in the
source directory window instead of a full filename.
The number entered for "Flags" should be a total of the above
depending on what you want to happen.
EXAMPLES:
If Flags=0 Then the result of clicking the button will be like
typing "run > nil: CommandName" from CLI. Hence the tooltype
"USER1=sys:Clock Clock" will cause the button for user1 to
read "Clock". When clicked it will RUN "sys:Clock", passing
nothing else to the program.
If Flags=65 your Program will not be invoked for any
directories, selected FileNames will be passed. Like
"run >nil: Program FileName" from CLI.
DEFAULT BUTTON SETTINGS:
Each of the buttons listed may be changed by a tooltypes line.
These examples show what that line would look like to obtain
exactly what the default setting for that button is.
PRINT=c:Print Print 65
"c:Print" is RUN and passed a FileName. No directories are
allowed. Control is returned to UtiliMaster while "c:Print"
runs. If Utilimaster can't find "c:print" (or whatever it's
been redefined to) an internal routine is used. Printer output
will be the same as screen format for "Read".
SHOW=c:Show Show 64
"c:Show is started and passed a FileName. Directories are not
allowed. Control IS NOT passed back to Utilimaster until
"Show" is done. This is to prevent Show from being run
simultaniously for several files.
SEARCH=c:Search 50 all "What text?"
A window is opened, and the equivelant of typing
"c:Search FileName <"E" box content> All" takes place.
If the "E" box is empty, a requester appears whith the prompt
"What text?". The text then entered is substituted.
ARC=c:Arc Arc 0 A
Arc is a special case. Equivelent CLI line:
"c:Arc A FileName [FileName] [FileName]"
DEARC=c:Arc De-Arc 0 V
Arc is a special case. Equivelent CLI line:
"c:Arc X FileName"
LISTARC=c:Arc "List Arc" 0 V
Arc is a special case. Equivelent CLI line:
"c:Arc V FileName"
RUN=c:Run Run 64
Equivelent CLI line: "c:Run FileName"
EDIT=c:E Edit 1
Equivelent CLI line: "c:Run c:E FileName"
EXECUTE=c:Execute Execute 68
Equivelent CLI line: "c:Ececute FileName"
NEWCLI=c:NewCli "New CLI"
Equivelent CLI line: "c:Run c:Newcli"
Please note that if a new command directory is defined, then
in each of the above examples, the new directory name will be
used in place of "c:".
Also note that any of these may be told to look for the program
in some other directory. For example, if you keep "Newcli" in
your "System" directory, you would then use tooltype
"NEWCLI=System:Newcli "New CLI""
(Note the quotes around "New CLI" for the button. Utilimaster
understands quotes and any group of words/letters inside
quotes is treated as one perameter regardless of spaces.
Occasionally an error will leave you with what amounts to a
CLI window opened. You escape this window with "Endcli"
When run from workbench, Utilimaster opens a background window.
You may change it's size by tooltype
"WINDOW=CON:<Left>/<Top>/<Width>/<Height>/"
If you use this, window MUST be "CON:" and ALL FOUR dimensions
MUST be given! (Unless you LIKE Guru Errors!)
There are some programs (The version of "Arc" that I have, for
example.) which send some of their output to ERROR out instead
of STANDARD out. This output will go to the background window
if started from WorkBench or the CLI from which UtiliMaster was
started. Sorry, I haven't figured out a way around this. You may
see this output by using the "Window to Front/Back" gadgets.
UtiliMaster is public domain software! (It's based on too
many predecessors!)
Please send comments and/or sugestions (or contributions) to:
John Scheib
3805 FairWay Circle
Las Vegas, Nevada 89108
OR
People Link: JSCHEIB
Enjoy UtiliMaster!